Authentication

The Knowledge Enrichment API uses Bearer Token Authentication with JWT (JSON Web Tokens) to secure access to its endpoints. All requests to protected resources must include a valid JWT in the Authorization header.

To complete authentication, send a POST request to retrieve an access token. For example, to obtain an access token for the Context Enrichment API, use the following endpoint:

curl -X POST https://auth.iam.experience.hyland.com/idp/connect/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "client_id=<your_client_id>" \
  -d "client_secret=<your_client_secret>" \
  -d "grant_type=client_credentials" \
  -d "scope=environment_authorization"

A response similar to the following is displayed:

{
  "access_token": "jwt.access.token",
  "expires_in": 900,
  "token_type": "Bearer",
  "scope": "environment_authorization"
}

Save the access token, which you can use to authenticate subsequent API requests. Include the token in the Authorization header of each request to protected endpoints.

Note: Tokens are time-limited. Once expired, you must request a new token using the authentication endpoint.

To use the Knowledge Enrichment APIs, see Tutorials.